EnigmA Amiga Run 1997 April/EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso/Recent1/DiskMaster21d.lha/DiskMasterII/DM2.guide

Amigaguide Document | 1997-03-16 | 93KB | 1,807 lines

@database  DiskMaster.guide
@master DiskMaster.guide
@$VER: DiskMaster.guide 0.13 (97-03-16)
@author "Rudolph Riedel"
@(c) "1997"
@node "Main" "DiskMaster-Guide Main"
@{b}-------------------------------------------------------------------------------
                                DiskMaster II
-------------------------------------------------------------------------------@{ub}
        Copyright
 1997 by Rudolph Riedel ([e-mail])
                           @{"      Introduction      " link "Intro" 0}
                           @{"       Copyrigth        " link "Copyright" 0}
                           @{"       Who did it?      " link "Slave" 0}
                           @{"       Disclaimer       " link "Disclaimer" 0}
                           @{"       Functions        " link "Functions" 0}
                           @{"      Distribution      " link "Dist" 0}
                           @{"    Tools and Sources   " link "Tools" 0}
                           @{"    Known Bugs in DM    " link "Bugs" 0}
                           @{"   Send your wishes!    " link "Wish" 0}
                           @{"        The Past!       " link "past" 0}
                           @{"       The Future?      " link "future" 0}
                           @{"     Cheers & Hellos    " link "Creds" 0}
@endnode
@node "Intro" "What`s that all about?"
@{b}-------------------------------------------------------------------------------
           What the heck is DiskMaster and why exists this Guide?
-------------------------------------------------------------------------------@{ub}
DiskMaster is simply one of the very best directory-utilities ever!
DM is small fast and compatible, easy to use, easy to configure.
And among the best things it comes for free now!
You simply have to try out DiskMaster to become one of it`s fans!
I came across DiskMaster early 1993, as far as I can remember.
To be honest, someone gave me a copy of this programme that
I tried out on my A500 with 1MB and Kick 1.3 .
Half a year later I really was into it and >honest< from then
I tried to buy the programme but there was nobody selling it.
We even tried to phone Progressive, this was back in 1994 or so.
In late 1994 I got hold of a copy of DiskMaster 2.1c,
again from an unknown source - no way to track it down.
In late 1995 I bought my modem - That finally opened the door.
As soon I had a connect to the german z-netz, I started writing adds.
But again no-one was willing or able to sell me the original.
It was in October 1996 when I finally made it to the internet.
On November 13. I put my first add in COMP.SYS.AMIGA.MARKETPLACE .
And the 16.11.1996 became the day, I was waiting for so long.
Jerry W. Rubemeyer from Iowa offered me his DiskMaster 2.0
together with the manual I ever needed so badly (100 pages).
Thanks again, Jerry!
On December 10. I put my first offer to swap Startup.DMs on the net.
The reactions on this and the following adds convinced me that I am
on the right way still supporting this splendid dir-util.
And as it seems that a lot of users received DiskMaster from the Cover-Disk
or from dubios sources like myself, I decided to write this guide to help all
these fellowers out there that are not so happy
to get hold of the original manual.
Additionally the manual is rather brief on some issues and I received a lot
of examples that I can provide to demonstrate the power of DiskMaster.
To my shame I basically copied the manual so far adding only few comments.
But I also provided some not mentioned functions.
The reason for this is that I wanted to have a solid basis first
to which I may attach new ideas easier.
And now that I received the source for DiskMaster, this is no longer a
stand-alone product but the official documentation for DiskMaster II.
I spent a lot of work on this, so apreciate it!
@endnode
@node "Copyright" "Copyright"
@{b}-------------------------------------------------------------------------------
                                  Copyrigth
-------------------------------------------------------------------------------@{ub}
@{b}DiskMaster@{ub} II is written by @{b}Greg Cunningham@{ub}
It`s his baby and I`m only a kind of step-father!
On 97-03-10 I finally received the source-code from Greg.
So at this point I will take over development or at least bug-fixing
DiskMaster to a more stable and even better point.
DiskMaster II is now
 1997 by Rudolph Riedel
The current Status of DiskMaster is Freeware.
-------------------------------------------------------------------------------
This Guide is
 1997 by Rudolph Riedel ([e-mail])
The current status of the Guide is @{b}Mailware@{ub}!
So if you use it, all I request is that you send me an e-mail or
a postcard to give me a little feedback for my work.
@endnode
@node "Slave" "The stupid that hacked all this text into his machine..."
@{b}-------------------------------------------------------------------------------
                                   Author
-------------------------------------------------------------------------------@{ub}
Yep, my name is Rudolph, exactly like the famous Reindeer... :^)
I was born 24.01.1972 in Ratzeburg, Germany
My Computer-Career started eons ago with a C64.
This little amazing machine ate a lot of my time as it demanded
more and more from me, resulting in a few demos and a game.
Then I came across Amigas. I hated them as any honest 64-freak did.
But I was finally overhelmed by the white-side of the force
and bought my very first A500.
After lots of wasted time and money I ended up with my A1200 now.
Today I`m working for a little company that produces and
developes high-end audio equipment for showmen.
If you have any questions to this Guide or to DiskMaster itself,
feel free to contact me at:
@{b} [e-mail]@{ub}
Please use "diskmaster" somewhere in the subject, this will help
me to bring back some structure into my pm.
I also like to receive your Startup.DM and ARexx-Scripts for DiskMaster.
And please excuse my sometimes bad style, English is not my native language.
@endnode
@node "Disclaimer" "This is really necessarry..."
@{b}-------------------------------------------------------------------------------
                                 Disclaimer
-------------------------------------------------------------------------------@{ub}
@{b}The  author  is in no way liable for any damages or loss of data
directly or indirectly caused by the information given in this document!
Some of the information could be false other could be easily misused.@{ub}
In other words:
When you try any of the descriped examples on your configuration you
do this completly on your own risk!
@{b}Like it`s not my fault when you delete your files, you pushed the button!@{ub}
DiskMaster itself is provided as is, you use it on you own risk!
@endnode
@node "functions" "Functions"
@{b}-------------------------------------------------------------------------------
               DiskMaster Functions - @{"  General Information  " link "GInfo" 0}
-------------------------------------------------------------------------------@{ub}
  @{"     About      " link "About" 0}  @{"     Delete     " link "Delete" 0}  @{"     Parent     " link "Parent" 0}  @{"     Select     " link "ScrFront" 0}
  @{" AddAutoCommand " link "AddAutoCmd" 0}  @{"    Deselect    " link "Deselect" 0}  @{"      Pens      " link "Pens" 0}  @{"    SetDate     " link "SetDate" 0}
  @{"   AddCommand   " link "AddCmd" 0}  @{"    Dirlist     " link "Dirlist" 0}  @{"      Play      " link "Play" 0}  @{"   SetFormat    " link "SetFormat" 0}
  @{" AddKeyCommand  " link "AddKeyCmd" 0}  @{"    DiskCopy    " link "DiskCopy" 0}  @{"     Print      " link "Print" 0}  @{"    SetList     " link "SetList" 0}
  @{" AddMenuCommand " link "AddMenuCmd" 0}  @{"     Expand     " link "Expand" 0}  @{"    PrintDir    " link "PrintDir" 0}  @{"   SetPattern   " link "SetPattern" 0}
  @{"    Archive     " link "Archive" 0}  @{"    External    " link "External" 0}  @{"    Priority    " link "Priority" 0}  @{"   SetPrinter   " link "SetPrinter" 0}
  @{"      Auto      " link "Auto" 0}  @{"      Find      " link "Find" 0}  @{"    Protect     " link "Protect" 0}  @{"     Single     " link "Single" 0}
  @{"  Backpattern   " link "Backpattern" 0}  @{"      Font      " link "Font" 0}  @{"      Quit      " link "Quit" 0}  @{"    ShowPic     " link "ShowPic" 0}
  @{"   BarFormat    " link "BarFormat" 0}  @{"     Format     " link "Format" 0}  @{"      Read      " link "Read" 0}  @{"     SortBy     " link "SortBy" 0}
  @{"     Batch      " link "Batch" 0}  @{"   HostScreen   " link "HostScreen" 0}  @{"     Reset      " link "Reset" 0}  @{"     Status     " link "Status" 0}
  @{"     Button     " link "Button" 0}  @{"      Lock      " link "Lock" 0}  @{"   Recursion    " link "Recursion" 0}  @{"     StdIO      " link "StdIO" 0}
  @{"     Check      " link "Check" 0}  @{"    Makedir     " link "Makedir" 0}  @{"     Rename     " link "Rename" 0}  @{"      Swap      " link "Swap" 0}
  @{" ChangeCommand  " link "ChgCmd" 0}  @{"      Move      " link "Move" 0}  @{"   ReqPattern   " link "ReqPattern" 0}  @{"  TitleFormat   " link "TitleFormat" 0}
  @{"  CloseWindow   " link "CloseWindow" 0}  @{"      Msg       " link "Msg" 0}  @{"      REXX      " link "REXX" 0}  @{"     UnLock     " link "UnLock" 0}
  @{"     Color      " link "Color" 0}  @{"     NewDir     " link "NewDir" 0}  @{"      Root      " link "Root" 0}  @{"     UnMark     " link "UnMark" 0}
  @{"    Comment     " link "Comment" 0}  @{"   OpenScreen   " link "OpenScreen" 0}  @{"   SaveConfig   " link "SaveConfig" 0}  @{"     Unpack     " link "Unpack" 0}
  @{"    Confirm     " link "Confirm" 0}  @{"   OpenWindow   " link "OpenWindow" 0}  @{"    ScrBack     " link "ScrBack" 0}  @{"      Wait      " link "Wait" 0}
  @{"      Copy      " link "Copy" 0}  @{"      Pack      " link "Pack" 0}  @{"    ScrFront    " link "ScrFront" 0}  @{"     Window     " link "Window" 0}
@endnode
@node "GInfo" "Some notes on the functions described"
@{b}------------------------------------------------------------------------------
                             General Information
------------------------------------------------------------------------------@{ub}
- All DiskMaster functions can be issued through ARexx.
  (Arexx only functions are marked)
- The entire command, including menu, title, @{"command" link "cmd" 0} string,
  etc., can be no longer than 255 characters.
- Due to restrictions in the function parser, all function names
  could be abreviated down to six characters.
  "External" could be abreviated as "Extern".
In the functions below, arguments enclosed in "< >" are required,
while those enclosed in "[ ]" are optinal.
My very own comments are marked with "*".
@endnode
@node "About" "About"
@{b}------------------------------------------------------------------------------
                                    About
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Brings up the "About"-Requester.
@{b}Syntax:@{ub} About
@{b}Arguments:@{ub} None
@endnode
@node "AddAutoCmd" "AddAutoCmd"
@{b}-------------------------------------------------------------------------------
                                 AddAutoCommand
-------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Adds an AutoCommand to the list.
          When a file double-clicked, DiskMaster attempts to determine
          what type of file it is by matching the first few bytes of
          the file to a list of known patterns.
          If those few bytes match any of the patterns, the corresponding
          AutoCommand will be executed upon that file.
@{b}Syntax:@{ub} AddAutoCmd [data,@{"pattern" link "pattern" 0},@{"command" link "cmd" 0}]
@{b}Arguments:@{ub}
@{b}(no arg):@{ub} If this function is issued with no arguments, a requester will appear
          asking for the proper arguments.
@{b}data:@{ub} The data compared against the first few bytes of the,
      to determine wheter or not this AutoCommand is to be executed.
      The "?" wild card character may be used to represent
      a single unknown character.
      Control characters are preceded by the "^" character.
      Two special flags may be used in place of the data: TEXT and DEFAULT.
      The TEXT AutoCommand will be executed if no other patterns
      are matched and the file is a text file.
      The DEFAULT AutoCommand will be executed
      if no other patterns are matched.
@{b}Examples:@{ub}
 AddAutoCmd FORM????ILBM,ShowPic @{"%s" link "flags" 0}
After double-clicking on a file, DiskMaster will read the first few bytes
of the file and attempt to match it with the pattern "FORM????ILBM",
which is the pattern for IFFILBM pictures.
If the pattern is matched, the command string
"ShowPic @{"%s" link "flags" 0}" will be executed.
 AddAutoCmd FORM????ILBM, *.iff, ShowPic @{"%s" link "flags" 0}
The file must end with ".IFF" and must match the data pattern also.
 AddAutoCmd , *.iff, ShowPic @{"%s" link "flags" 0}
The data doesn't matter, but the filename must end with .IFF to match.
@endnode
@node "AddCmd" "AddCmd"
@{b}-------------------------------------------------------------------------------
                                 AddCommand
-------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Adds a command to the current command window.
@{b}Syntax:@{ub} AddCmd [title,##,@{"command" link "cmd" 0}]
@{b}Arguments:@{ub}
@{b}title:@{ub} The text that will appear in the command window to
       identify this command.
@{b}##:@{ub} A two digit number, specifying the foreground and background
    colors to be used to display the @{b}Title@{ub} text.
    The two numbers used are DM color palette register values.
@{b}Example:@{ub}
 AddCmd   DH0:,10,NewDir DH0:*
Adds a command called "  DH0:" to the current command window,
which when activated, changes the current window directory to dh0: .
The text "  DH0:" will be displayed using color 1 as its forground
and color 0 as its background.
@endnode
@node "AddKeyCmd" "AddKeyCmd"
@{b}------------------------------------------------------------------------------
                               AddKeyCommand
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Add a keyboard command.
@{b}Syntax:@{ub}   AddKeyCmd [key,@{"command" link "cmd" 0}]
@{b}Arguments:@{ub}
@{b}key:@{ub} The key to be pressed for the command.
@{b}Examples:@{ub}
 AddKey c,Copy @{"%s" link "flags" 0} @{"%d" link "flags" 0}
Press "c" to begin a file copy.
 AddKey C,Copy @{"%s" link "flags" 0}
Press SHIFT+C to start a copy that requests dest path.
@endnode
@node "AddMenuCmd" "AddMenuCmd"
@{b}------------------------------------------------------------------------------
                                 AddMenuCommand
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Adds a new menu entry to the current menu strip.
@{b}Syntax:@{ub} AddMenuCmd [menu_name,title,key,@{"command" link "cmd" 0}]
@{b}Arguments:@{ub}
@{b}menu_name:@{ub} The name of an existing or new menu to which
           the new menu item will be added.
@{b}title:@{ub} The text that will appear in the menu to identify this command.
@{b}key:@{ub} A single printable character to be used in conjunction with the
     @{b}[Right Amiga]@{ub} key to activate this command from the keyboard.
     The character used is not case sensitive.
     However, special characters such as "&" or "
" will require
     the use of the @{b}[Shift]@{ub} or @{b}[Alt]@{ub} keys to invoke the command.
@{b}Example:@{ub}
 AddMenu Config,About,A,About
Adds an item called "About" under the "Config" menu, which can be activated
by pressing @{b}[Right Amiga]@{ub} + @{b}[D]@{ub}.
@{b}Hint:@{ub} In the Startup.DM, adding menus prior to opening any windows
               will increase the speed of the script execution.
@endnode
@node "Archive" "Archive"
@{b}------------------------------------------------------------------------------
                                     Archive
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Provides a multi-select feature taylor-made for file archivers.
@{b}Syntax:@{ub} Archive [ArcCommand]
@{b}Arguments:@{ub}
@{b}ArcCommand:@{ub} The external archive command with it`s normal "Add" arguments.
@{b}Example:@{ub}
 Archive "LHA <* -r a"
Opens a requester asking for the archive name, then adds all selected files to
the existing archive, or creates a new archive file.
* Unfortunatly "Archive" will always open a requester thus it could not be
  "misused" as all-purpose multi-select function.
@endnode
@node "Auto" "Auto"
@{b}------------------------------------------------------------------------------
                                   Auto
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Uses auto commands on all selected files.
@{b}Syntax:@{ub} Auto [@{"file" link "file" 0}]
@{b}Example:@{ub}
 AddCmd Auto,20,Auto @{"%s" link "flags" 0}
Adds the Command "Auto" to the CommandWindow that when selected will
batch process all selected files.
@endnode
@node "Backpattern" "Backpattern"
@{b}------------------------------------------------------------------------------
                              Backpattern
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Loads any size IFF ILBM as a pattern.
@{b}Syntax:@{ub} Backpattern <@{"file" link "file" 0}> [[P]alette]
@{b}Arguments:@{ub}
@{b}P:@{ub} Use the color palette of the selected picture.
@{b}Examples:@{ub}
 Back "Env:DMPattern.ilbm"
Loads the specified file.
 Back @{"%s" link "flags" 0} P
Loads the selected file and uses it's color palette.
 Back
Clears the pattern.
* I use the whole screen for DM-windows so I won`t see the pattern anyways...
@endnode
@node "BarFormat" "BarFormat"
@{b}------------------------------------------------------------------------------
                                  BarFormat
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Specifies which information and in what order it is to appear
          in the title bar of the Workbench or DiskMaster screen.
@{b}Syntax:@{ub} BarFormat [text][%V][%C][%F][%P][%T][%D][%M][%Y][%W]
@{b}Arguments:@{ub}
@{b}text:@{ub} Any text you like to be displayed in the title-bar.
@{b}%V:@{ub} Displays the current version-number of DM.
@{b}%C:@{ub} Amount of available CHIP RAM.
@{b}%F:@{ub} Amount of available FAST RAM.
@{b}%F:@{ub} Amount of available (public) RAM in total.
@{b}%T:@{ub} Displays the current time.
@{b}%D:@{ub} Displays the current date.
@{b}%M:@{ub} Displays the current month (abreviated).
@{b}%Y:@{ub} Displays the current year.
@{b}%W:@{ub} Displays the current weekday (abreviated).
@{b}Example:@{ub}
 BarFormat "DM %V Chip:%C  Fast:%F  Total:%P  %W - %D.%M.%Y  %T"
Will result in a title bar that might look like this:
 @{b}DM 2.1c Chip:1530064  Fast:14823088  Total:16353152  Sun - 9.Feb.97  9:30PM@{ub}
@endnode
@node "Batch" "Batch"
@{b}------------------------------------------------------------------------------
                                  Batch
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Executes a DiskMaster batch file.
@{b}Syntax:@{ub} Batch [@{"file" link "file" 0}]
@{b}Example:@{ub}
 Batch @{"%s" link "flags" 0}
Executes the selected files in the source window as DiskMaster script files.
@endnode
@node "Button" "Button"
@{b}------------------------------------------------------------------------------
                                  Button
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Assigns a function to the @{b}S@{ub} (source) and @{b}D@{ub} (destination) gadgets.
          Clicking on @{b}S@{ub} or @{b}D@{ub} gadget will invoke the command.
@{b}Syntax:@{ub} Button "@{"command" link "cmd" 0}"
@{b}Example:@{ub}
 Button "Parent"
When the @{b}S@{ub} or @{b}D@{ub} gadget is selected, the "Parent" function is performed.
@endnode
@node "Check" "Check"
@{b}------------------------------------------------------------------------------
                                  Check
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Totals the number of bytes in the specified files or path and
          determines wheter or not there is room on the destination device to
          hold the files if copied.
          If there is enough room, the amount of storage space
          that will be left is displayed.
          If there is not enough room, you will be informed.
          All feedback is displayed in the DiskMaster screen title bar.
@{b}Syntax:@{ub} Check <path>
@{b}Arguments:@{ub}
@{b}path:@{ub} The AmigaDOS path which is to be totaled and
      compared to the destination.
@{b}Example:@{ub}
 Check @{"%s" link "flags" 0}
Totals the byte count of the selected files and directories and indicates
wheter or not they will fit in the destination directory.
* This function was broken untill version 2.1a .
  Without a destination choosen the programme bombed.
@endnode
@node "ChgCmd" "ChgCmd"
@{b}------------------------------------------------------------------------------
                              ChangeCommand
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Requests that you select a command to be altered,
          then open a requester allowing you to edit the command
          without editing the configuration file directly.
@{b}Syntax:@{ub} ChgCmd
@{b}Arguments:@{ub} None
@endnode
@node "CloseWindow" "CloseWindow"
@{b}------------------------------------------------------------------------------
                                CloseWindow
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Closes the current window.
@{b}Syntax:@{ub} CloseWindow
@{b}Arguments:@{ub} None
* Could be of use in ARexx-Scripts.
@endnode
@node "Color" "Color"
@{b}------------------------------------------------------------------------------
                                    Color
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Sets the RGB values (in hexadecimal) of each color register.
@{b}Syntax:@{ub} Color [colors]
@{b}Arguments:@{ub}
@{b}(no arg):@{ub} Opens the palette requester allowing you
          to visually chnage the color palette.
@{b}colors:@{ub} The set of hexadecimal values specifying the RGB value
        of the color palette register. The color registers are set from
        left to right with each RGB value separated with a space.
@{b}Examples:@{ub}
 Color
Opens the palette requester.
 Color 999 222 EEE 358
Sets the first four colors.
* Notice the 4 Bit per entry values.
  One of the first things I ever did in usage of DM, was to write a tiny
  programm that opens a reqtools-palette requester
  to superseed the internal DM one.
@endnode
@node "Comment" "Comment"
@{b}------------------------------------------------------------------------------
                             Comment (@{"Recursive" link "recursive" 0})
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Changes the comment text of the specified file.
@{b}Syntax:@{ub} Comment <@{"file" link "file" 0}> ["text"]
@{b}Arguments:@{ub}
@{b}(no arg):@{ub} Opens a requester with the current comment to be edited.
@{b}Examples:@{ub}
 Comment @{"%s" link "flags" 0}
Opens a requester with the current comment to be edited
for each selected file.
 Comment @{"%s" link "flags" 0} "Babelfish`n`Chips"
Sets the comment "Babelfish`n`Chips" for each selected file.
@endnode
@node "Confirm" "Confirm"
@{b}------------------------------------------------------------------------------
                                  Confirm
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Opens a requester displaying a message, a "Continue" gadget,
          a "Stop" Gadget and a text line.
          All text in this requester can be customized.
          If the user selects the "Continue" gadget the requester will
          dissappear and the remainder of the command string
          will be executed.
          If the User selects the "Stop" gadget, the requester will disappear
          and the remainder of the command string will be disregarded.
@{b}Syntax:@{ub} <"text"> [Continue] [Stop] [edit text]
@{b}Arguments:@{ub}
@{b}text:@{ub} The text that will appear as headline in the requester.
      If the text is to contain spaces, it must be included in quotes.
@{b}Continue:@{ub} The text that will be displayed in the "Continue" gadget.
@{b}Stop:@{ub} The text that will be displayed in the "Stop" gadget.
      If this text is specified, the "Continue text must also be specified.
@{b}edit text:@{ub} The text that will be displayed in the string gadget.
If any text is to contain spaces, it must be included in quotes.
@{b}Examples:@{ub}
 Confirm " Drop dead?" "Yo!" "No way!";Quit
Opens a simple requester without string gadget to confirm the action "quit".
 Confirm "Name of encoded file?" "Go!" "Stop!" .uu;Extern uuencodex @{"%s" link "flags" 0} @{"%r" link "flags" 0}
Opens a requester which string gadget contains the string ".uu"
that can be modified by the user and is accessed as @{"%r" link "flags" 0}.
@endnode
@node "Copy" "Copy"
@{b}------------------------------------------------------------------------------
                            Copy (@{"Recursive" link "recursive" 0})
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Copies the specified file(s) to the specified destination.
@{b}Syntax:@{ub} Copy <@{"file" link "file" 0}> <@{"dest" link "dest" 0}> [Newer]
@{b}Arguments:@{ub}
@{b}Newer:@{ub} If this flag is set files will only be copied if the source file
       of the same name is newer than the file in the destination directory
       or if the file does not exist there.
@{b}Examples:@{ub}
 Copy @{"%s" link "flags" 0} @{"%d" link "flags" 0}
Copies selected source files to the destination directory.
 Copy DF0: DF1:
Copies all files from DF0: to DF1:
@endnode
@node "Delete" "Delete"
@{b}------------------------------------------------------------------------------
                                   Delete
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Deletes the specified file(s).
@{b}Syntax:@{ub} Delete <@{"file" link "file" 0}>
@{b}Example:@{ub}
 Delete @{"%s" link "flags" 0}
Deletes selected files and directories in the source window.
@endnode
@node "Deselect" "Deselect"
@{b}------------------------------------------------------------------------------
                                  Deselect
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Deselects files and directories based on pattern matching.
@{b}Syntax:@{ub} Deselect [@{"pattern" link "pattern" 0}]
@{b}Arguments:@{ub}
@{b}(no arg):@{ub} Opens a requester asking for a pattern to match.
@{b}Examples:@{ub}
 Deselect
Opens a requester asking for a pattern to match.
 Deselect *
Deselects all files and directories in the current window.
 Deselect *.info
Deselects all files and directories ending with ".info".
@endnode
@node "Dirlist" "Dirlist"
@{b}------------------------------------------------------------------------------
                              Dirlist (ARexx only)
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Gets the contents of the current window with
          selected / deselected status.
@{b}Syntax:@{ub} Dirlist [variable]
@{b}Arguments:@{ub}
@{b}variable:@{ub} Name of the list variable to be used by the ARexx programm for
          the information obtained from the DiskMaster window.
@{b}Example:@{ub}
address DM
Dirlist List
do i=1 to List.0
 parse var List.i name +30 size +8 time +9 date +7 prot +9 cmt +80 dir0 +1 sel
 say name size time date prot dir sel
Displays directory of the current window in console window.
* I haven`t figured out the format of the list.
  If someone is smart enough to figure it out then please explain it to me.
  Even though I used this function in my script "FastDMView.rexx"
  I won`t claim that I fully understood it.
@endnode
@node "DiskCopy" "DiskCopy"
@{b}------------------------------------------------------------------------------
                                DiskCopy
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Performs sector copy from source floppy disk to destination
          floppy disk(s).
@{b}Syntax:@{ub} DiskCopy <source> <dest0> [dest1] [dest2] [dest3] [MULTI]
@{b}Arguments:@{ub}
@{b}(no arg):@{ub} Opens a diskcopy requester allowing you to visually
          set all diskcopy options.
@{b}source:@{ub} The floppy drive to be used as the source drive.
@{b}dest0:@{ub} The furst floppy drive to be used as the destination drive.
@{b}destN:@{ub} Optional destination drives.
@{b}MULTI:@{ub} Multiple Copy flag allowing more than one set of copies to be
       made from a single reading of the source disk.
@{b}Example:@{ub}
 DiskCopy Df0: Df0: Df1: MULTI
Reads the disk in DF0: into memory, then wrties to DF0: and DF1: .
After each set pf copies is complete, you will be prompted to insert additional
disks into DF0: and DF1: to make additional copies.
Pressing @{b}ESC@{ub} will abort the operation.
* I consider this function as obsolete.
  At first there exists a lot of programms out there that are much smarter
  on the job as they were specialized to do so.
  The second point is that I rarely use my diskdrive.
@endnode
@node "Expand" "Expand"
@{b}------------------------------------------------------------------------------
                                  Expand
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Specifies whether the expanded AmigaDOS volume and path names or
          unexpanded device names will be used to display directory paths.
@{b}Syntax:@{ub} Expand [ON|OFF]
@{b}Arguments:@{ub}
@{b}(no arg):@{ub} Toggles between the two modes.
@{b}ON:@{ub} Specifies that all paths are to be expanded to their fullest.
@{b}OFF:@{ub} Specifies that physical and logical device names will be used as
     part of the directory path.
@{b}Example:@{ub}
 Expand ON
Tells DiskMaster to expand all path names.
* I prefer "Expand OFF" to prevent any troubles from equal volume names
  when I have the harddisk from a friend attached to my system.
@endnode
@node "External" "External"
@{b}------------------------------------------------------------------------------
                             External (@{"Recursive" link "recursive" 0})
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Use external programs as DiskMaster functions.
@{b}Syntax:@{ub} External [@{"command" link "cmd" 0}] [args]
@{b}Arguments:@{ub}
@{b}args:@{ub} Arguments normally used by the external program. The "@{"%s" link "flags" 0}" and
      "@{"%d" link "flags" 0}" flags may be used to specify source and destination directories,
       or selected source files or directories.
       To run multiple external functions from the same command,
       separte them by placing a "\" between each function.
@{b}Examples:@{ub}
 External munpack @{"%s" link "flags" 0} -f >nil:
Runs the "MUnpack" command providing the first selected file in the source
window as the name of the file to be "de-mimed".
 External stack 30000\Tools:GfxCon %s Format GIF
Runs multiple external commands. First sets stack to 30000, then runs
the "GFXCon" program telling it to convert the selected picture(s) into GIF.
@endnode
@node "Find" "Find"
@{b}------------------------------------------------------------------------------
                           Find (@{"Recursive" link "recursive" 0})
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Searches the path for files containing the current pattern.
          When a file is found which matches the specified pattern, a requester
          will appear asking if you want to continue the search,
          abort the search or open a window displaying the directory
          where the file was found.
@{b}Syntax:@{ub} Find [@{"file" link "file" 0}]
@{b}Examples:@{ub}
 Find @{"%s" link "flags" 0}
Search the selected paths using the current pattern.
 SetPattern "+.txt"; Find DF0:
Search DF0: for files ending with ".txt".
@endnode
@node "Font" "Font"
@{b}------------------------------------------------------------------------------
                                  Font
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Changes the font to be used for file and command display.
@{b}Syntax:@{ub} Font [name/size]
@{b}Arguments:@{ub}
@{b}name/size:@{ub} The name and size of the font.
           The font must be located in the "Fonts:" directory.
           If the font is not found, the default font is used.
@{b}Examples:@{ub}
 Font clean/8
Set font to clean.font, 8 point
 Font @{"%s" link "flags" 0}
Set font to selected file ( i.e. SYS:Fonts/topaz/8, or Fonts:topaz.font)
Note: The use of proportional fonts is @{b}NOT@{ub} recommended as they
      will cause alignment problems!
@endnode
@node "Format" "Format"
@{b}------------------------------------------------------------------------------
                                  Format
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Formats one or more floppy disks.
@{b}Syntax:@{ub} Format <DFx:> [name] [DFx:] [name] ... [INSTALL|QUICK|FFS|VERIFY]
@{b}Arguments:@{ub}
@{b}DFx::@{ub} The drive to be used to format a disk.
@{b}name:@{ub} The name to be given to the disk being formatted in the
      previously specified drive.
@{b}INSTALL:@{ub} Makes the newly formatted disk "bootable".
@{b}QUICK:@{ub} Specifies that the directory of the disk will be cleared instead
       of a full format being performed.
@{b}FFS:@{ub} Use the FastFilingSystem on that disk.
@{b}VERIFY:@{ub} Speciefies that the disk is to be verified during format.
@{b}Examples:@{ub}
 Format
Opens DiskMaster`s format requester.
 Format DF0: Empty0 DF1: Empty1 DF2: Empty2 INSTALL QUICK
Formats disks in DF0:, DF1: and DF2: with diff. names, installing each,
and uses the QUICK option (fast clear).
* I also call this option obsolete, try to protest against or it will be
  thrown out in a later release to make some space.
@endnode
@node "HostScreen" "HostScreen"
@{b}------------------------------------------------------------------------------
                                HostScreen
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Use a puplic screen as host.
@{b}Syntax:@{ub} HostScreen [name]
@{b}Arguments:@{ub}
@{b}name:@{ub} The name of a public screen.
@{b}Example:@{ub}
 HostScreen BAUD
All windows after this will open on the BaudBandit screen.
@endnode
@node "Lock" "Lock"
@{b}------------------------------------------------------------------------------
                                 Lock
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Locks a window as either a source or destination window.
          This function allows for the use of multiple source
           and/or destination windows.
@{b}Syntax:@{ub} Lock [S|D]
@{b}Arguments:@{ub}
@{b}S:@{ub} Locks window as source window.
@{b}D:@{ub} Locks window as destination window.
@{b}Examples:@{ub}
 Lock S
Locks last selected window as a SOURCE window.
 Lock D
Locks last selected window as a DESTINATION window.
@endnode
@node "MakeDir" "MakeDir"
@{b}------------------------------------------------------------------------------
                                 MakeDir
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Creates a new directory.
@{b}Syntax:@{ub} MakeDir [name]
@{b}Arguments:@{ub}
@{b}(no arg):@{ub} Opens a string requester.
@{b}name:@{ub} The name to be given to the new directory.
@{b}Examples:@{ub}
 MakeDir
Opens a requester asking for the name of the new directory.
 MakeDir RAM:T
Makes a directory in RAM: called "T".
@endnode
@node "Move" "Move"
@{b}------------------------------------------------------------------------------
                               Move (@{"Recursive" link "recursive" 0})
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Copies the specified file(s) from the source to the
          destination then deletes the specified file(s) from the source.
@{b}Syntax:@{ub} Move <@{"file" link "file" 0}> <@{"dest" link "dest" 0}> [NEWER]
@{b}Arguments:@{ub}
@{b}NEWER:@{ub} This flag specifies that only files of like names which
       have a newer file date than the existing files are to be moved.
@{b}Examples:@{ub}
 Move @{"%s" link "flags" 0} @{"%d" link "flags" 0}
Moves selected files from the source window to the destination window.
 Move @{"%s" link "flags" 0} RAM:
Moves selected files from the source window to the RAM: directory.
 Move @{"%s" link "flags" 0}
Requests the destination directory, then moves selected files
from the source window to that destination.
@endnode
@node "Msg" "Msg"
@{b}------------------------------------------------------------------------------
                                  Msg
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Displays text in the DiskMaster screen title bar.
@{b}Syntax:@{ub} Msg "text"
@{b}Arguments:@{ub}
@{b}text:@{ub} Any text which is to be displayed in the DiskMaster screen title bar.
@{b}Example:@{ub}
 Msg "Do something!"
Displays the message "Do something!" in the DiskMaster screen title bar.
@endnode
@node "NewDir" "NewDir"
@{b}------------------------------------------------------------------------------
                                  NewDir
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Changes the directory path of the source window.
@{b}Syntax:@{ub} NewDir [path|dmfile]
@{b}Arguments:@{ub}
@{b}path:@{ub} AmigaDOS path name.
@{b}dmfile:@{ub} DiskMaster script file to be executed in lieu of reading
        a new directory.
@{b}Examples:@{ub}
 NewDir
Changes the path of the current window to "none" which displays
the device list.
 NewDir RAM:*.info
Changes the path of the current window to RAM: (displays only .info files).
@endnode
@node "OpenScreen" "OpenScreen"
@{b}------------------------------------------------------------------------------
                                 OpenScreen
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Opens a custom screen.
@{b}Syntax:@{ub} OpenScreen [planes] [LACE|HALF] [A|AutoScroll width height]
                   [S|SuperHires]
                   [P|Productivity] (still not tested)
@{b}Arguments:@{ub}
@{b}planes:@{ub} The number of bitplanes to use for the custom screen.
        This determines how many colors will be available for that screen.
        One (1) bitplane will provide two (2) colors,
        Two (2) bitplanes will provide four (4) colors,
        and three (3) bitplanes will provide eight (8) colors.
@{b}LACE:@{ub} Specifies that the custom screen is to be opened in
      interlace mode.
@{b}HALF:@{ub}  If interlace mode is used, specifies that the custom
       screen is to open on the lower half of the screen only.
@{b}A:@{ub} Opens a screen of the given width and height that will be scrolled
   automatically when the screen is bigger than display size (OS2 and up only).
   * Beware! There is no minimum screen size implemented yet!
@{b}S:@{ub} Opens the custom screen in Super-Hires mode.
@{b}P:@{ub} Opens the custom screen in Productivity mode.
@{b}Examples:@{ub}
 OpenScreen 3 LACE
Opens an eight (8) color interlace screen.
 OpenScreen 2 LACE A 1024 1024
4 color autoscroll 1024x1024 (under 2.0 only)
* This function is one of these I like to rework.
@endnode
@node "OpenWindow" "OpenWindow"
@{b}------------------------------------------------------------------------------
                                  OpenWindow
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Opens a file display or command window on the current DM screen.
@{b}Syntax:@{ub} OpenWindow [left top width height [path|dmfile|CMD]]
@{b}Arguments:@{ub}
@{b}left:@{ub} The pixel coordinate for the left boundary of the window.
@{b}top:@{ub}  The pixel coordinate for the top boundary of the window.
@{b}width:@{ub} The width of the window (in pixels).
@{b}height:@{ub} The height of the window (in pixels).
@{b}path:@{ub} The DOS path to be read and displayed in the newly opened window.
@{b}dmfile:@{ub}  The file name of a DiskMaster script file that will be
         executed upon the opening of the new window.
@{b}CMD:@{ub} Command Flag.  This flag specifies that the newly opened
     window will take over as the current command window.
@{b}Examples:@{ub}
 OpenWindow 100 150 200 50 RAM:
Open a new window which will load and display the directory "RAM:".
 OpenWindow 100 150 200 50 C:s*
Opens a new window which will display only files which start with
"S" in the C: directory.
 OpenWindow 100 150 200 50
Opens a new window which will display the device list.
 OpenWindow 100 150 200 50 CMD
Opens a new window which will take over as a new command window.
@endnode
@node "Pack" "Pack"
@{b}------------------------------------------------------------------------------
                             Pack (@{"Recursive" link "recursive" 0})
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Compress a file using internal single file compression method.
          A ".dmp" extension is added automatically.
@{b}Syntax:@{ub} Pack [@{"file" link "file" 0}] [signature]
@{b}Arguments:@{ub}
@{b}signature:@{ub} An up to four character signature that will be included in the
           header of the file for later identification by an auto command.
           The pattern is: DMP0xxxx
@{b}Examples:@{ub}
 Pack @{"%s" link "flags" 0}
Opens a requester, asking for a signature then packs all selected files
using the same signature.
 Pack @{"%s" link "flags" 0} txt
Using "txt" as signature will result in "DMPtxt" as header of the file.
* Nearly undocumented features are my favourite to explain... :-)
@endnode
@node "Parent" "Parent"
@{b}------------------------------------------------------------------------------
                                  Parent
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Displays the contents of the parent directory in the
          current directory path of the source window.
@{b}Syntax:@{ub} Parent
@{b}Arguments:@{ub} None
@endnode
@node "Pens" "Pens"
@{b}------------------------------------------------------------------------------
                                  Pens
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Allows you to customize which color register is used
          for each AmigaDOS 2.0 pen.
@{b}Syntax:@{ub} Pens [color]
@{b}Arguments:@{ub}
@{b}color:@{ub} This is the DiskMaster palette register number to be used
       for the specific AmigaDOS 2.0 pen.  There may be as few as two,
       and as many as eight register numbers, depending on the number of
       bitplanes being used.
       The position of the color numbers specifies which AmigaDOS 2.0
       pen will be assigned that color.  The positions are as follows:
        1 = Detail Pen
        2 = Block Pen
        3 = Text Pen
        4 = Shine Pen
        5 = Shadow Pen
        6 = HighFill Pen
        7 = HighFill Text Pen
        8 = Background Pen
        9 = Highlight Text Pen
       Note: Refer to your AmigaDOS 2.0 manual for a description of the
       purpose of each of these pen attributes.
@{b}Example:@{ub}
 Pens 0 1 1 0 2 1 3 0 1
Assigns color registers 0-3 to AmigaDOS 2.0 pens, as specified by
their position.
* Reported to be buggy or at least not compliant to DM 2.0 .
  I was not able to set the color for the directory text.
@endnode
@node "Play" "Play"
@{b}------------------------------------------------------------------------------
                                  Play
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Play a music module.
@{b}Syntax:@{ub} Play [@{"file" link "file" 0}]
@{b}Arguments:@{ub}
@{b}(no arg):@{ub} Stops the musik and unloads the module.
@{b}Examples:@{ub}
 Play @{"%s" link "flags" 0}
Plays the selected file as a SoundTracker/NoiseTracker/ProTracker module.
  Play
Stops playing.
* The player is not allocating the channels nor testing if the channels are
  already allocated thus making it possible to play a .mod while a
  player like "Deli-Player" is running in the background.
  The second bad thing is that it causes errors in data-transfers
  thus making a z-modem download a mess.
  This function is nearly gone, use one of the available cli-players instead.
@endnode
@node "Print" "Print"
@{b}------------------------------------------------------------------------------
                                  Print
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Prints specified file(s) (text or picture).
@{b}Syntax:@{ub} Print <@{"file" link "file" 0}> [HEX]
@{b}Arguments:@{ub}
@{b}HEX:@{ub} Specifies that the file is to be printed in hexadecimal
     format rather than in text or graphic format.
@{b}Example:@{ub}
 Print @{"%s" link "flags" 0}
Prints all selected files in the source window.
@endnode
@node "PrintDir" "PrintDir"
@{b}------------------------------------------------------------------------------
                                  PrintDir
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Prints selected files/dirs in source window using current format.
@{b}Syntax:@{ub} PrintDir @{"file" link "file" 0} output
@{b}Arguments:@{ub}
@{b}output:@{ub} The logical device the text shall be passed to.
@{b}Examples:@{ub}
 PrintDir @{"%s" link "flags" 0} PRT:
Prints a list of all selected files using the printer.
 PrinDir @{"%s" link "flags" 0} RAM:x
Generates a file ram:x that contains the list of selected files.
@endnode
@node "Priority" "Priority"
@{b}------------------------------------------------------------------------------
                                 Priority
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Change the current AmigaDOS priority of DiskMaster.
          Changing this priority value can have an effect on other running
          programs.  It is recommended that unless you are familiar with the
          effects of changing program priorities, you should leave the
          DiskMaster priority at its default setting.
@{b}Syntax:@{ub} Priority [#]
@{b}Arguments:@{ub}
@{b}(no arg):@{ub}  Selecting this command will open a requester,
           allowing you to edit the current priority value.
@{b}#:@{ub} The new priority value.
Example:
 Priority 0
Sets the DiskMaster priority to 0.
* Totally unnecessary.
@endnode
@node "Protect" "Protect"
@{b}------------------------------------------------------------------------------
                              Protect (@{"Recursive" link "recursive" 0})
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Changes protection/attribute bits on specified file(s).
@{b}Syntax:@{ub} Protect <@{"file" link "file" 0}> ["[+] [-] [hsparwed] [G]"]
@{b}Arguments:@{ub}
@{b}+:@{ub} Specifies that the following bits are to be turned ON.
@{b}-:@{ub} Specifies that the following bits are to be turned OFF.
@{b}hsparwed:@{ub} Optional list of bits to be turned ON or OFF when
          preceded by a plus (+) sign or minus (-) sign.
          If the plus or minus signs are NOT used,
          the list will specify the absolute bit settings.
          The bits have the following meanings:
          H - Indicates that the file should be Hidden.
          * Ofcourse NOT!
            From OS2 to 3.0 "H" was the "Hold"-Bit,
            used by the OS to automatically make "pure" commands resident.
            The support for "Hold" was removed in OS3.1 .
            Please make no use of it.
          S - Indicates that the file is an AmigaDOS Script.
          P - Indicates that the file is Pure and can be made Resident.
          A - Archive Bit; used by hard disk backup programs to indicate
              whether or not the file has been backed up.  This bit is
              automatically reset to OFF if any other tool has written to
              the file.
          R - Indicates that the file may be Read.
          W - Indicates that the file may be Written to.
          E - Indicates that the file may be Executed.
          D - Indicates that the file may be Deleted.
          Note: If bits to be turned on or off are not specified, a
          requester will appear displaying the current protect bit
          settings, allowing you to edit them.
@{b}D:@{ub} Global flag.
   When this flag is present, the requester will
   not appear for each selected file.
   Instead, the current bit setting are used for all selected file(s).
@{b}Examples:@{ub}
 Protect @{"%s" link "flags" 0}
Opens a requester, asking for protection bits to be edited for
each selected file.
 Protect @{"%s" link "flags" 0} RWED
Sets each file to "----RWED"
 Protect @{"%s" link "flags" 0} "+S-P"
Turns the script bit ON and turns the pure bit OFF on each selected file.
 Protect @{"%s" link "flags" 0} +D
Make all selected files deletable.
@endnode
@node "Quit" "Quit"
@{b}------------------------------------------------------------------------------
                                  Quit
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Exits DiskMaster.
@{b}Syntax:@{ub} Quit
@{b}Arguments:@{ub} None
@endnode
* The most useless function... ;^)
@node "Read" "Read"
@{b}------------------------------------------------------------------------------
                                 Read (@{"Recursive" link "recursive" 0})
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Opens DiskMaster's built-in file reader
          to read the specified file(s).
@{b}Syntax:@{ub} Read  <@{"file" link "file" 0}> [HEX] [LACE|HALF] [SEARCH["Text"]]
@{b}Arguments:@{ub}
@{b}HEX:@{ub}  Specifies that the file reader is to use its "Hexadecimal" mode.
      In this mode, the file will be displayed in both Hexidecimal and ASCII.
@{b}LACE:@{ub} Specifies that the file reader is to be opened in interlace mode.
@{b}HALF:@{ub} If interlace mode is used, specifies that the file reader
      is to open on the lower half of the screen only.
@{b}SEARCH:@{ub} Specifies that a search is to be made on the specified file(s).
@{b}Text:@{ub} If a search is to take place, specifies the search string.
      If SEARCH is specified, but this argument is omitted,
      a requester will open first to ask for the search string.
@{b}Using the Reader:@{ub}
Once the reader has loaded the file and opened its screen,
the first page of text is displayed.
The file reader does not wrap the text.
Scrolling:
@{b}Cursor Left/Right@{ub} (@{b}Keypad 4/6@{ub}): Move the display window by eight columns.
@{b}Cursor Up/Down@{ub} (@{b}Keypad 8/2@{ub}): Move the display window by one line.
@{b}Shift Cursor Up/Down@{ub} (@{b}Keypad 9/3@{ub}): Move the display window page-wise.
@{b}T@{ub} / @{b}Keypad 7@{ub} : Top of file.
@{b}B@{ub} / @{b}Keypad 1@{ub} : Bottom of file.
@{b}Space@{ub} / Left Mouse : Toggle "Jump" mode / "Smooth" mode.
When in "Smooth" mode, placing the pointer in the center of the screen will
pause the scroll.  Moving the pointer a short distance up or down from center
will cause the display to move slowly in the direction of the pointer movement.
Moving the pointer up or down to the near top or bottom of the screen will
cause the display to quickly scroll in the direction of the mouse movement.
Searching:
@{b}S@{ub} : Opens a requester asking you for a string to search.
The search string requester will accept the wild card characters
"?" (single unknown) and "*" (multiple unknown).  When in
hexadecimal display mode, entering a hexadecimal value preceded
with a "$" will search for that hexadecimal string.
After entering the search string, the reader will search the file for the
specified string. If the string is found, the portion of the file will be
displayed where the string first occurs, with each occurrence of
the string highlighted.
@{b}C@{ub} : Continue the search.
To exit the file reader you can click on the close gadget at the upper left
corner of the screen, or press [Q], [Esc], [Enter], or [Return], or the mouse.
@{b}Examples:@{ub}
 Read @{"%s" link "flags" 0} LACE
Read selected text file(s) using an interlaced screen.
 Read @{"%s" link "flags" 0} Lace Hex
Opens the reader in interlace and in hexadecimal display mode.
 Read @{"%s" link "flags" 0} SEARCH "bubblegum"
Read selected text file(s) and search for the string "bubblegum".
@endnode
@node "Reset" "Reset"
@{b}------------------------------------------------------------------------------
                                 Reset
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Resets DiskMaster to a primitive state
          in which it contains no windows or menus.
          By placing this command at the beginning of a script,
          a running DiskMaster can be completely re-configured.
@{b}Syntax:@{ub} Reset
@{b}Arguments:@{ub} None
@endnode
@node "Recursion" "Recursion"
@{b}------------------------------------------------------------------------------
                                Recursion
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Enables or disables recursion, allowing for functions
          to be performed on a directory without having it performed on the
          files within that directory.
@{b}Syntax:@{ub} Recursion ON|OFF
@{b}Arguments:@{ub}
@{b}ON:@{ub} Enables recursion.
@{b}OFF:@{ub} Disables recursion.
@{b}Example:@{ub}
 Recursion OFF;Rename @{"%s" link "flags" 0}
This will allow you to rename a directory, and will not attempt
to rename any files within that directory.
@endnode
@node "Rename" "Rename"
@{b}------------------------------------------------------------------------------
                                 Rename
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Renames specified files and/or directories.
@{b}Syntax:@{ub} Rename <@{"file" link "file" 0}> [new]
@{b}Arguments:@{ub}
@{b}new:@{ub} The file's or directory's new name.
     Without this argument, a requester will open asking for the new name.
@{b}Example:@{ub}
 Rename @{"%s" link "flags" 0}
Opens a requester asking for the new name of each selected file.
The requester uses the old name as a default, allowing you to edit it.
@endnode
@node "ReqPattern" "ReqPattern"
@{b}------------------------------------------------------------------------------
                                ReqPattern
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub}  Opens a requester asking for a pattern to be matched
           when directories are selected.  A default pattern, and custom
           text in the title bar and gadgets may be included.
@{b}Syntax:@{ub} ReqPattern "text" [@{"pattern" link "pattern" 0}] [Okay Abort Cancel]
@{b}Arguments:@{ub}
@{b}text:@{ub} Text to be displayed in the requester's title bar.
      If the text included spaces, it must be enclosed in quotes.
@{b}Okay Abort Cancel:@{ub} This requester is used for both recursive and
                   nonrecursive operations, and contains three gadgets.
                   The first gadget accepts the pattern and closes the
                   requester, the second gadget aborts the entire (recursive)
                   operation and the third aborts the current operation.
                   The text for each of the gadgets can be changed,
                   however their functions will remain the same.
@{b}Example:@{ub}
 ReqPattern "Please enter pattern" *.c
Requests pattern to be used in the current operation with "*.c" as the default.
@endnode
@node "REXX" "REXX"
@{b}------------------------------------------------------------------------------
                                 REXX
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Executes the specified ARexx program or string.
@{b}Syntax:@{ub} REXX [file|"string"]
@{b}Arguments:@{ub}
@{b}file:@{ub} Name of ARexx program to be executed.
@{b}string:@{ub} ARexx command(s) to be executed.  The ARexx string must
be enclosed in quotes.
@{b}Examples:@{ub}
 REXX "parse arg x,say x" @{"%s" link "flags" 0}
Echoes each selected filename to the console window previously
opened with the "StdIO" command.
 Rexx FastDMView.rexx @{"%p" link "flags" 0}
Executes the Arexx-Script "FastDMView" providing the current path as argument.
@endnode
@node "Root" "Root"
@{b}------------------------------------------------------------------------------
                                     Root
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Displays the root directory of the current window path.
@{b}Syntax:@{ub} Root
@{b}Arguments:@{ub} None
@endnode
@node "SaveConfig" "SaveConfig"
@{b}------------------------------------------------------------------------------
                                  SaveConfig
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Saves a batch file that will recreate the current
          environment exactly.
@{b}Syntax:@{ub} SaveConfig [file][ICON]
@{b}Arguments:@{ub}
@{b}(no arg):@{ub} Opens a requester asking for the name of the file to
          be written or overwritten with the environment information.
          The file will be saved with an icon.
@{b}file:@{ub} Name of file to be written or overwritten with the
      environment information.
@{b}ICON:@{ub} Specifies that an icon is to be provided for the saved file.
@{b}Example:@{ub}
 SaveConfig Startup.DM ICON
Saves the file as "Startup.DM" (with an icon).
@endnode
@node "ScrBack" "ScrBack"
@{b}------------------------------------------------------------------------------
                                 ScrBack
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Pushes the DiskMaster screen behind other existing screens.
@{b}Syntax:@{ub} ScrBack
@{b}Arguments:@{ub} None
@endnode
@node "ScrFront" "ScrFront"
@{b}------------------------------------------------------------------------------
                                  ScrFront
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Brings the DiskMaster screen to the front of other existing screens.
@{b}Syntax:@{ub} ScrFront
@{b}Arguments:@{ub} None
@endnode
@node "Select" "Select"
@{b}------------------------------------------------------------------------------
                                  Select
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Selects file in the source window using the specified pattern.
@{b}Syntax:@{ub} Select [@{"pattern" link "pattern" 0}]
@{b}Arguments:@{ub}
@{b}(no arg):@{ub} Opens a requester asking for the pattern for the selection.
@{b}Examples:@{ub}
 Select *
Selects all files and directories in the current window.
 Select *.info
Selects all files and directories in the current window which end with ".info".
@endnode
@node "SetDate" "SetDate"
@{b}------------------------------------------------------------------------------
                             SetDate (@{"Recursive" link "recursive" 0})
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Changes the file date and time of the specified file(s).
@{b}Syntax:@{ub} SetDate [@{"file" link "file" 0}] [date]
@{b}Arguments:@{ub}
@{b}date:@{ub} The date to be written to the specified file(s).
      The date must be specified in the format hh:mm:ss ddmmyy.
      If no date is supplied, the current date and time will be used.
@{b}Example:@{ub}
 SetDate @{"%s" link "flags" 0}
Sets the date of all selected files in the source window to the
current time and date.
@endnode
@node "SetFormat" "SetFormat"
@{b}------------------------------------------------------------------------------
                                  SetFormat
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Specifies which, and in what order information is
          displayed in the file display windows.
@{b}Syntax:@{ub} SetFormat [N] [S] [T] [D] [M] [Y] [W] [A] [C] [Text]
@{b}Arguments:@{ub}
@{b}(no arg):@{ub} Opens a requester allowing you to edit the current format.
@{b}N:@{ub} File name
@{b}S:@{ub} File size
@{b}T:@{ub} Time
@{b}D:@{ub} Date
@{b}M:@{ub} Month
@{b}Y:@{ub} Year
@{b}W:@{ub} Day of week
@{b}A:@{ub} File atributes (protection bits)
@{b}C:@{ub} File comment
@{b}Text:@{ub} Any text that is to be displayed along with the file information.
@{b}Examples:@{ub}
 SetFormat
Opens a requester allowing you to edit the current format.
 SetFormat "S N A T W D-M-Y C"
Changes format to SIZE NAME ATTRIBUTES TIME WWW DD-MMM-YY COMMENT
 SetFormat "NS C"
Changes format to SIZE NAME COMMENT
* The "Text" option is somewhat useless since even qouted characters
  will be interpreted - text without a/c/d/m/n/s/t/w/y works fine...
@endnode
@node "SetList" "SetList"
@{b}------------------------------------------------------------------------------
                               SetList @{b}(ARexx Only)@{ub}
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Displays items in a list in a file display window,
          allowing you to use it as an ARexx item selection window.
          Using the "GetDir" command, the status of this list
          (selected/deselected) is returned to the ARexx program.
@{b}Syntax:@{ub} SetList <stem_name>
@{b}Arguments:@{ub}
@{b}stem_name:@{ub} The stem name of the list (defined in an ARexx program)
           to be displayed.  The list must be defined prior to
           issuing this command and must be in the following format:
           SList.1='One' SList.2='Two' SList.3-'Three'
@{b}Example:@{ub}
 SetList SList
Displays the items in "SList" in the current file display window.
@endnode
@node "SetPattern" "SetPattern"
@{b}------------------------------------------------------------------------------
                                SetPattern
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Sets the pattern for the current operation, overriding
          the pattern specified by "@{"ReqPattern" link "ReqPattern" 0}".
@{b}Syntax:@{ub} SetPattern @{"pattern" link "pattern" 0}
@{b}Example:@{ub}
 SetPattern *.c
Sets pattern for current operation to *.c.
@endnode
@node "SetPrinter" "SetPrinter"
@{b}------------------------------------------------------------------------------
                                SetPrinter
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Opens the printer option requester, allowing you to
          change the current printer setup.
@{b}Syntax:@{ub} SetPrinter
@{b}Arguments:@{ub} None
* Isn`t the requester-layout awful? This is annother subject to change.
@endnode
@node "Single" "Single"
@{b}------------------------------------------------------------------------------
                                 Single
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} This function tells the (@{"recursive" link "recursive" 0}) function to occur only once
          when activated, regardless of how many files are selected.
@{b}Syntax:@{ub} Single
@{b}Arguments:@{ub} None
@{b}Example:@{ub}
 Single;Delete %s
Would delete only one selected file, without deleting any
directory or its contents.
@endnode
@node "ShowPic" "ShowPic"
@{b}------------------------------------------------------------------------------
                              ShowPic (@{"Recursive" link "recursive" 0})
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Displays IFF ILBM picture files, or plays IFF 8SVX sound files.
@{b}Syntax:@{ub} ShowPic [@{"file" link "file" 0}] [seconds]
@{b}Arguments:@{ub}
@{b}seconds:@{ub} The number of seconds the picture file is to be
         displayed (this argument does not affect sound files).
@{b}Example:@{ub}
 ShowPic @{"%s" link "flags" 0}
Shows/Plays all selected files in the source window.
* The same problem with the sample-player as with the "play" function,
  no channel allocation or checking...
@endnode
@node "SortBy" "SortBy"
@{b}------------------------------------------------------------------------------
                                 Sortby
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Changes the sorting method
@{b}Syntax:@{ub} Sortby [Name] [Size] [Date]
@{b}Arguments:@{ub}
@{b}Name:@{ub} Displays all files sorted by name.
@{b}Size:@{ub} Sorts by size, smallest files displayed first.
@{b}Date:@{ub} Sorts by Date, oldest files first.
@{b}Example:@{ub}
 SortBy Name
* I am working on it...
@endnode
@node "Status" "Status"
@{b}------------------------------------------------------------------------------
                               Status @{b}(ARexx Only)@{ub}
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Returns string in result for ARexx programs.
@{b}Syntax:@{ub} Status <P> <F> <V> <H> <D>
@{b}Arguments:@{ub}
@{b}P:@{ub} Returns current path of source window.
@{b}D:@{ub} Returns current destination path.
@{b}F:@{ub} Returns current file display format.
@{b}V:@{ub}    Returns "DiskMaster V2.1c" or whatever the current version is.
@{b}H:@{ub}    Returns public screeen name or host screen.
@{b}Example:@{ub}
 Status P
@endnode
@node "StdIO" "StdIO"
@{b}------------------------------------------------------------------------------
                                 StdIO
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Opens or closes an Input/Output window to allow
          interaction with external program.
@{b}Syntax:@{ub} StdIO [filespec] [CLOSE]
@{b}Arguments:@{ub}
@{b}filespec:@{ub} Standard console window information such as the
          console handler, window dimensions and window title.
@{b}Close:@{ub} Closes previously opened I/O window.
       This argument may appear at the end of the command string which
       opened the I/O window.
@{b}Examples:@{ub}
 StdIO "CON:240/20/260/40/DiskMaster I/O"
Opens a console window.
 StdIO CLOSE
Closes the window.
Note: The I/O window opened by DiskMaster is NOT a CLI window.
It is available to provide a method of program interaction for those programs
which such, but do not supply their own method of communication.
@endnode
@node "Swap" "Swap"
@{b}------------------------------------------------------------------------------
                                  Swap
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Swaps the directory paths between the two
          most recently active windows.
          If only two windows are open,
          will swap the directory paths between the two.
@{b}Syntax:@{ub} Swap
@{b}Arguments:@{ub} None
@endnode
@node "TitleFormat" "TitleFormat"
@{b}------------------------------------------------------------------------------
                                TitleFormat
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Specifies which, and in what order information is
          displayed in the file display window title bar.
@{b}Syntax:@{ub} TitleFormat [%C] [%F] [%I] [%B] [Text]
@{b}Arguments:@{ub}
@{b}%C:@{ub} Number of files in directory.
@{b}%F:@{ub} Amount of available (free) space on the disk.
@{b}%I:@{ub} Number of files selected in the window.
@{b}%B:@{ub} Total number of bytes in the selected files.
@{b}Text:@{ub} Any text that you may want to display in the window title bar.
@{b}Example:@{ub}
 TitleFormat Selected: %I of %C Files totaling %B Bytes
Displays a mixture of text and system information resulting in a
window title bar that may appear as below:
@{b}Selected: 5 of 20 Files totaling 24674 Bytes@{ub}
@endnode
@node "UnLock" "UnLock"
@{b}------------------------------------------------------------------------------
                                 UnLock
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Unlocks the selected window, or all windows.
@{b}Syntax:@{ub} UnLock [ALL]
@{b}Arguments:@{ub}
@{b}(no arg):@{ub} Unlocks the currently selected window.
@{b}ALL:@{ub} Unlocks all windows.
@endnode
@node "UnMark" "UnMark"
@{b}------------------------------------------------------------------------------
                                UnMark
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Enables or Disables automatic deselection of files during operations.
          This feature allows multiple operations to be performed
          on a set of selected files without the need of
          re-selecting them after each operation.
@{b}Syntax:@{ub}  UnMark [ON|OFF]
@{b}Arguments:@{ub}
@{b}ON:@{ub} Enables deselection.
@{b}OFF:@{ub} Disables deselection.
@{b}Example:@{ub}
 UnMark OFF;Copy @{"%s" link "flags" 0} @{"%d" link "flags" 0}
Copies all selected files without deselecting them.
@endnode
@node "Unpack" "Unpack"
@{b}------------------------------------------------------------------------------
                             Unpack (@{"Recursive" link "recursive" 0})
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Decompress a file using internal single file compression method.
@{b}Syntax:@{ub} Unpack [@{"file" link "file" 0}]
@{b}Example:@{ub}
 Unpack @{"%s" link "flags" 0}
Unpack all selected .dmp files.
@endnode
@node "Wait" "Wait"
@{b}------------------------------------------------------------------------------
                                  Wait
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Causes a timed delay or a cued delay.
@{b}Syntax:@{ub} Wait [seconds]
@{b}Arguments:@{ub}
@{b}(no arg):@{ub} Asks user to press [return] (A StdIO window must be open)
@{b}seconds:@{ub}  The number of seconds to wait before proceeding with
          the remainder of the command string.
@{b}Example:@{ub}
 Wait 4
Waits for 4 seconds.
@endnode
@node "Window" "Window"
@{b}------------------------------------------------------------------------------
                                Window
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub} Selects a window, making it the source window.
@{b}Syntax:@{ub} Window <Path|DEST|NEXT>
@{b}Arguments:@{ub}
@{b}Path:@{ub} An AmigaDOS path.
      The window that matches the specified path will be selected.
@{b}DEST:@{ub} Selects the destination window.
@{b}Next:@{ub} Selects the window which appears as the nest window in the list.
@endnode
@node "" ""
@{b}------------------------------------------------------------------------------
                                  x
------------------------------------------------------------------------------@{ub}
@{b}Function:@{ub}
@{b}Syntax:@{ub}
@{b}Arguments:@{ub}
@{b}:@{ub}
@{b}:@{ub}
@{b}:@{ub}
@{b}Examples:@{ub}
@endnode
@node "flags" "Flags"
@{b}------------------------------------------------------------------------------
                               DiskMaster Flags
------------------------------------------------------------------------------@{ub}
%s - The selected file or drawer with full path.
%d - The destination path.
%p - The source path.
%r - The string from a requester. (also returned in RESULT for ARexx)
@endnode
@node "cmd" "Command"
@{b}------------------------------------------------------------------------------
                              The "Command" Keyword
------------------------------------------------------------------------------@{ub}
@{b}command:@{ub} The command-string DiskMaster will execute when you selected an
         option from the menu or the CommandWindow, when you double-clicked
         a file and it matched with one of the AutoCommands
         or when you press a key for a Key-Command.
The string may contain several internal or external functions seperated by ";".
@endnode
@node "file" "File"
@{b}------------------------------------------------------------------------------
                            The "File" Keyword
------------------------------------------------------------------------------@{ub}
@{b}file:@{ub} The file or drawer you selected to perform a function on.
      This could be provided absolute or as @{"%s" link "flags" 0}.
@endnode
@node "pattern" "Pattern"
@{b}------------------------------------------------------------------------------
                            The "Pattern" Keyword
------------------------------------------------------------------------------@{ub}
@{b}pattern:@{ub} Any printable text may be used as the pattern to be matched.
         The wild card characters "?" (single unknown) and "*" (multiple
         unknown) may also be used.
@endnode
@node "dest" "dest"
@{b}------------------------------------------------------------------------------
                            The "dest" Keyword
------------------------------------------------------------------------------@{ub}
@{b}dest:@{ub} The destination path.
      The @{"%d" link "flags" 0} flag may be used in place of this argument to specify
      that the path specified by the destination window is to be used.
@endnode
@node "recursive" "Recursive"
@{b}------------------------------------------------------------------------------
                                 Recursive
------------------------------------------------------------------------------@{ub}
Functions marked as "Recursive" will work on all selected files and
all files in selected directories by being invoked untill the function
was performed on all of them.
When you have five files selected and perform the @{"Comment" link "Comment" 0} function
on them, then the requester will pop up five times to let you enter the comment
for the selected file in the row.
* The default-setting for "comment" is:
AddCMD Comment, Comment,Recurse OFF;Comment @{"%s" link "flags" 0}
So you won`t be able to set the comments for files within a selected drawer.
Otherwise you are able to set a comment for a selected drawer.
@endnode
@node "Dist" "The goodies included..."
@{b}------------------------------------------------------------------------------
                You should find these file in the archive:
------------------------------------------------------------------------------@{ub}
@{"ARexx" link "scripts" 0}
DM2               80408 Bytes 2.1c
DM2.guide         86028 Bytes 0.13
DM2.guide.info      856 Bytes
DM2.info           1640 Bytes
MyStartup.dm       8698 Bytes 2.18
MyStartup.DM.info   850 Bytes
@endnode
@node "scripts" "Arexx-Magic"
@{b}------------------------------------------------------------------------------
                           ARexx-Scripts included:
------------------------------------------------------------------------------@{ub}
AssignList.rexx     1723 Bytes     by @{b}Steven D. Kapplin@{ub}
DM-Vir.DM           2765 Bytes 1.1 by @{b}Inorix Scripts (Jan-willem van Eys)@{ub}
DMSpopper.rexx      1162 Bytes 1.0 by R.Riedel
FastDMView.rexx      728 Bytes 2.1 by R.Riedel
FileShow.rexx       9000 Bytes 3.1 by @{b}Inorix Scripts (Jan-willem van Eys)@{ub}
Sub_FileRecog.REXX  3344 Bytes 2.8 by @{b}Inorix Scripts (Jan-willem van Eys)@{ub}
@{b}AssignList.rexx@{ub} :
AssignList.rexx - DiskMaster utility to get assign an create new command
window which contains a listing of all mounted volumes and assigns.
When you click on any items in the list a new DM window will open
with a listing of the directory for the selected device or assign.
Makes it easier to navigate through you hard drive system.
You may also add additional devices which may not show up in
the lists produced by ARexx's showlist() function.
@{b}DM-Vir.DM@{ub} :
Intelligent Viruskiller script for DiskMaster II.
It will check for running Virus_Checker v7.18+ or VirusZ II v1.33+.
If neither is running, it will start one.
@{b}DMSpopper.rexx@{ub} :
An example script to show the power of ARexx.
It opens a new command window for special treatment of autodetected DMS files.
@{b}FastDMView.rexx@{ub} :
A multi-selection script for FastView.
FastView has the ability to load and process as much pictures as there
is space in your memory.
The bad thing is that DM has no multi-selection feature and FastView`s
command line is restricted to 256 Bytes in length.
So this script is the solution.
@{b}FileShow.rexx@{ub} :
A File_ID.diz extractor for DiskMaster II
@{b}Sub_FileRecog.REXX@{ub} :
FileRecog subroutine
FR_T clip : Filetype
FR_S clip : Short type identifier
FR_I clip : first 48 chars as hex string
 Known filetypes:
 ----------------
 Archives: LZH,LHA,LHA-SFX,LZX,ZIP,ARC,RAR,ARJ,DMS,Zoom,XMash,XArchive,
           PackDev.
 Packed  : XPK,PP20.
 Images  : GIF,JPEG,IFF,ANIM.
 Sound   : WAVE,8SVX.
 Other   : EXE,ICON,GUIDE,IntroCAD.
 IFF     : ILBM,ANIM,8SVX,CTLG,PREF,CDAF,FAXX,STFax.
@endnode
@node "Tools" "All the little helpers listed..."
@{b}------------------------------------------------------------------------------
      This tells more about all the little extra utilities beeing used:
------------------------------------------------------------------------------@{ub}
Most of the tools I use to expand the capabilities of DM
could be found on aminet.
Nevertheless I`ll try to give you more information on all these little
helpers like the complete path on aminet and the version numbers.
FastView - a fast AGA GFX-viewer
- under construction...
@endnode
@node "Bugs" "Bugs"
@{b}------------------------------------------------------------------------------
                 These are the known Bugs in DiskMaster 2.1c
------------------------------------------------------------------------------@{ub}
- The Text Reader is limited to 10000 lines or 500k or something.
- The sorting algo is awfully slow, even though written in assembler.
 Some "Benchmarks:"
                 SortBy:
  Files:     Name:     Fast: (my beta, doing no sort at all)
   2890    27:60 sec   5:50 sec
   6092  1:52:45 min  12:20 sec
  10002  4:51:05 min  20:06 sec
- DM crashes on screens too deep.
  This is something I was not able to confirm anymore.
  Works fine with 8 planes on my AGA/3.1 machine.
- The Textreader misses the end on internally crunched files.
- It`s 1.3 compatible.
- The "openscreen" function is far from being perfect,
  a screenmode requester has to be implemented.
- The listviews can`t be scrolled using the keys.
- I`m missing a %n Flag for a long time now.
- some obsolete functions as "DiskCopy" and "Format" could be removed.
- not 100% C -> even more work to make it portable to pOS or the like.
- The soundplayer sux. I will remove it or replace it if I find
  a more system-friendly source.
- "Pens" seems to be broken.
- "SaveKonfig" uses def_tool.info instead of def_project.info .
Please report any bug you are aware of to make this list more complete!
@endnode
@node "wishes" "You want it?"
@{b}------------------------------------------------------------------------------
                   What features do you like to see in DM?
------------------------------------------------------------------------------@{ub}
Development will go on!
At first I want to fix some bugs and implement some of the features I
had in mind for a long time now.
I like to get DM even smaller and faster, with more funtionality of course.
As I already received one mail concerning this: MUI will NOT be used!
But I will make use of new OS functions and therefore the support for
Kickstart 1.3 will be dropped for sure!
And If there is something I just have to implement from OS 3 ,
the support for OS 2 will also be sacrified.
And now it`s your turn.
If you have any ideas on how DM could be improved, then send me a mail!
@endnode
@node "Past" "All the tortures listed below..."
@{b}------------------------------------------------------------------------------
                               History
------------------------------------------------------------------------------@{ub}
                          @{" DM2 - the binary " link "bin" 0}
                          @{" DM2 - the guide  " link "guide" 0}
@endnode
@node "bin" "DM2"
@{b}------------------------------------------------------------------------------
                 What happened to the binary so far:
------------------------------------------------------------------------------@{ub}
- 97-03-11 recompiled using SAS-C 6.57 and Includes 40.15
From the file "Programme_Changes" that came with the cover disk:
v2.1c Fixes:
    Printer setup now shows the proper values instead of always 0.
    This must be what's causing the other problems with output, since
    you can't see what the values really are.
    Print doesn't switch to HEX when the file is less than 199 bytes.
    PrintDir now works.
    PrintDir will exclude escape code if the output is not PRT:.
I've also added *some* AGA support.
I had a 4000/Toaster to test for a couple of days.
All but HAM8 hires work fine.
P.S.  Can you believe all the bugs were caused by the SAS/C v6.0 sprintf()
function?
DISKMASTER 2.00 -> 2.03 CHANGES:
 Title bar clock update under 2.0
 Archive files with spaces (uses quotes)
 Multiple sources with 'unmark off' commands (i.e. SizeCheck)
 'Read %s SEARCH' automatically starts, and skips to next file when it
    reaches the end.
 Default Arc extract menu item was missing a space. "Arc <*x %s"
 Doesn't assume device names are null terminated.
In batch files, ";" as the first character can be used to comment out a
  line.
Fixed startup lock stuff:
    OpenWindow
    Lock S
    OpenWindow
    Lock D
  This was not locking the source window.
 Single and double quotes can be intermixed in batch like ARexx.
Additions/changes:
  About and other requesters will show the version/revision number in the
    title.
  Added "Copy %s %d RENAME" (asks for new filename while copying)
  Added %P (source path without filename)
        %R (requester string)
Reader now accepts 'M' key (mode change) switches between hex/ascii, menu
    button exits the reader, added line/lines page/pages.
DISKMASTER 2.03 -> 2.04 CHANGES:
 Added %V (version) to Barformat so title will show current version.
Superbitmap scrolling in ShowPic is faster.
 Fixed Size Check for correct calculations between FFS and non-FFS.
Now syncronous rexx.  "REXX command %s" will now be given each filename
    as before, but DM now waits for the command to return before continuing
    on to the next.
DISKMASTER 2.04 -> 2.1 CHANGES:
 Added FFS to format.
 Added HD formatting, but not tested.
Added Backdrop pattern/picture for custom screens.
Diskchange and directory modification detect enhanced.
2.0 pens are saved in the config.
Fixed crash when deleting files when sorting by date.
Project icon DefaultTool path is expanded so it will always find DM.
Fixed font selection problem in printer setup.
DISKMASTER 2.1 -> 2.1a CHANGES:
 Fixed S<->D swap bug; now no longer crashes machine.
 Fixed the addition of Hex information when saving a STARTUP.DM file;
  this bug especially noticable on floppy-based systems.
Fixed Progressive logo.
 Fixed CHKsize bug; When a SOURCE device was checked, if there wasn't a
  DESTINATION chosen, the programme would bomb.
@endnode
@node "guide" "DM2.Guide"
@{b}------------------------------------------------------------------------------
                  What happened to the guide so far:
------------------------------------------------------------------------------@{ub}
0.13 (97-03-16) - reworked "Introduction" section
                - reworked "Copyright" section
                - renamed "Available Scripts" in "Distribution"
                  and included a new section "ARexx"
                  (Just for your pleasure, Jan-Willem ;)
                - added "Wish" section
                - reworked "History" section
                - third Aminet release (or second since the last
                  one seems to be lost somewhere)
0.12 (97-03-15) - received "DiskMasterII.Doc" from Mike Hendren
                  this will prevent me from typing 25k text at least!
                - added "dest" section
                - added "Lock", "MakeDir", "Move", "Msg", "NewDir",
                  "OpenScreen", "OpenWindow", "Pack", "Parent", "Pens".
                  "Play", "Print", "PrintDir", "Priority", "Protect", "Quit"
                  "Read", "Reset", "Recursion", "Rename", "ReqPattern", "REXX",
                  "Root", "SaveConfig", "ScrBack", "ScrFront", "Select",
                  "SetDate", "SetFormat", "SetList", "SetPattern",
                  "SetPrinter", "Single", "ShowPic", "SortBy", "Status",
                  "StdIO", "Swap", "TitleFormat", "UnLock", "UnMark",
                  "Unpack", "Wait", "Window"
                - my "raving-shoes" will never forgive me this "lost" saturday
                - all functions added now, > 8 hours of work today!
0.11 (97-03-10) - received the source to DM from Greg
                  including some typed info that could be
                  added to my guide
                - started to OCR some pages, unfortunatly
                  M$ does not seem to like my approach as
                  WinDoom permanently crashes... :-(
                - added "Expand", "External" & "Find"
                  from my first OCR session
                  two hours - two pages ?!!?
                - some updates, some changes...
                - added "Font"
                - added "Format"
                - added "Hostscreen" - faster without OCR...
                - second pre-release to aminet
0.10 (97-03-08) - possibly found someone to OCR me a bunch of pages
                - cosmetics
                - a few sentences added
                - added "Delete" (have to do something:)
                - added "Deselect"
                - changed the button layout in the "Functions"-section
                - added section "General Information"
                - added section "Pattern"
                - fixed some text
                - added "Dirlist"
                - added "DiskCopy"
0.9 (97-03-01) - added "Confirm"
               - added "Copy"
               - cosmetics
               - first pre-release to aminet
0.8 (97-02-27) - changed the version-number, just for the fun of it :^)
0.7 (97-02-26) - no motivation to leave the house today,
                 rain is nice - watched from the right side of a window...
               - added "Check"
               - added some minor important text
               - increased readability by dividing between
                 commands and functions (?)
               - added "ChgCmd"
               - added "CloseWindow"
               - added "Color"
               - added "Comment"
               - added section "Recursive"
               - seven pages from the manual done, 29 to go,
                 this will grow to 150k I guess now
0.6 (97-02-22) - added a new Chapter - "Known Bugs"
               - added statement from Greg Cunningham to the copyright-section
               - added "Batch"
               - added section "Flags"
               - added "Button"
               - added section "File"
               - added "Backpattern"
               - annother three hours "invested", have to find a way
                 to OCR at least a few pages from the manual
0.5 (97-02-09) - restructured the .guide a bit to save space
                 and increase readability
               - cosmetics
               - a bit silly but added "About" as this is a real function too
               - added "Archive"
               - added "BarFormat"
               - added "Auto"
0.4 (97-02-06) - finished "AddAutoCommand"
               - added "AddKeyCommand"
               - added "AddCommand"
               - added "AddMenuCommand"
               - bugfixes
0.3 (97-01-30) Lots`a text still to be added...
0.2 (97-01-29) First structures are visable...
0.1 (97-01-28) First steps in creating amigaguide-documents...
@endnode
@node "future" "What`s next?"
@{b}------------------------------------------------------------------------------
                        The road-map for future-releases:
------------------------------------------------------------------------------@{ub}
- Add much more information to the list and provide more "exotic" examples
- Bugfixes
- more scripts to be bundeled with this release
- send your wishes
- a survey on the users demands for new functions in DM2 and
  the removal of absolete functions like the "DiskCopy" for example
@endnode
@node "Creds" "Howdy Friends!"
@{b}------------------------------------------------------------------------------
                                      Credits
------------------------------------------------------------------------------@{ub}
Special Greetings to:
Greg Cunningham    - Thank you!
Jerry W. Rubemeyer - You finally ended my quest - many thanks!
The following persons gave me a hand on creation of this document:
Mike Hendren - thank you for providing the DiskMasterII.Doc!!
J.M.S.oftware - whoever you are, thanks for typing the manual!
Fast Greetings to:
Dave Haynie   - Thank you for the hardware!
The OS3 Team  - Very nice work guys, but please complete it someday...
Nico Francois - Wherever you are...
Personal Greetings to:
Richard Backhaus - my all-purpose coding-slave :-)
Jacques Bojart   - long term brother in arms...
Henrik Doerfler  - I still remember the day when I came from Volker`s place...
Nicolas Franck   - I really want that ProWizard update...
Thomas Kelly     - Thank you for a very interesting Mail-Thread!
Magnus Kutz      - What about a trip to the "Body`n`Soul"?
Ingmar Mix       - I won`t trust you again in dating with girls...
Martin Sass      - Let`s have a party again!
Patrick Schimpke - The szene`s dead anyway... :-(
Timo Treeter     - Thank you for the party-panic, honey.. :^)
@endnode